Skip to content

update and refine the fully converged design after team discussion#249

Open
liunick-msft wants to merge 6 commits intomainfrom
dev/nl/updateFullyConvergedDoc
Open

update and refine the fully converged design after team discussion#249
liunick-msft wants to merge 6 commits intomainfrom
dev/nl/updateFullyConvergedDoc

Conversation

@liunick-msft
Copy link
Collaborator

This pull request updates Azure Local documentation to recommend a simplified and more efficient storage VLAN configuration for Fully Converged deployments. The new guidance recommends mapping one storage VLAN per ToR switch (rather than both VLANs on both switches), clarifies failover behavior, and updates diagrams, tables, FAQs, and configuration examples accordingly. The changes aim to improve clarity, reduce configuration complexity, and reflect current best practices.

Documentation and Configuration Guidance Updates:

  • Updated the recommended design for Fully Converged deployments to use one storage VLAN per ToR switch (Storage VLAN A on ToR-A, Storage VLAN B on ToR-B), rather than configuring both VLANs on both switches. Clarified that this design simplifies configuration and provides automatic failover without loss of functionality. [1] [2] [3] [4] [5]
  • Revised all relevant tables, diagrams, and configuration code blocks to reflect the new VLAN-to-ToR mapping in both the overview and reference documentation. [1] [2] [3] [4] [5] [6]
  • Updated FAQ sections and key design principle explanations to describe the new recommended pattern, clarify failover behavior, and note that configuring both VLANs on both switches is optional and does not improve resiliency. [1] [2] [3]
  • Adjusted sample switch configuration snippets to match the updated VLAN assignments, ensuring only the relevant storage VLAN is allowed on each ToR’s trunk ports and in VLAN definitions. [1] [2] [3]
  • Improved language throughout to emphasize that this change reduces complexity, maintains automatic failover, and is validated by testing. [1] [2] [3] [4]

Copilot AI review requested due to automatic review settings February 12, 2026 19:33
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Azure Local ToR networking documentation to recommend a simplified Fully Converged storage VLAN design (one storage VLAN per ToR), and aligns reference/configuration guidance and troubleshooting steps with that approach.

Changes:

  • Replaced “both storage VLANs on both ToRs” guidance with a “one storage VLAN per ToR (recommended)” baseline and clarified failover behavior.
  • Updated NX-OS sample configuration snippets (allowed VLAN lists / VLAN definitions) and updated FAQs to match the revised pattern.
  • Updated Environment Validator troubleshooting guidance to reflect the revised VLAN-to-ToR mapping.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
TSG/Networking/Top-Of-Rack-Switch/Reference-TOR-Fully-Converged-Storage.md Updates key design principle, FAQs, and switch config examples for the new fully converged storage VLAN recommendation.
TSG/Networking/Top-Of-Rack-Switch/Overview-Azure-Local-Deployment-Pattern.md Updates deployment pattern overview/FAQ language and tables to reflect the recommended per-ToR storage VLAN mapping.
TSG/EnvironmentValidator/Networking/Troubleshoot-Network-Test-StorageConnections-ConnectivityCheck.md Adjusts troubleshooting guidance for converged storage connectivity checks to align with the recommended VLAN placement.

@AlBurns-MSFT
Copy link
Collaborator

@liunick-msft It looks like you didn't address the copilot review yet. Once that's done I'll review as well.

Copy link
Contributor

Copilot AI commented Mar 16, 2026

@liunick-msft I've opened a new pull request, #262, to work on those changes. Once the pull request is ready, I'll request review from you.

…gn update (#262)

* Initial plan

* Remove VLAN 712 from ToR1 configuration block (one storage VLAN per ToR)

Co-authored-by: liunick-msft <105009141+liunick-msft@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: liunick-msft <105009141+liunick-msft@users.noreply.github.com>
Copy link
Contributor

Copilot AI commented Mar 16, 2026

@liunick-msft I've opened a new pull request, #263, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot AI and others added 2 commits March 16, 2026 08:40
…erence doc (#263)

* Initial plan

* Unify all TOR switch naming to TOR-A and TOR-B in Reference-TOR-Fully-Converged-Storage.md

Co-authored-by: liunick-msft <105009141+liunick-msft@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: liunick-msft <105009141+liunick-msft@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Contributor

Copilot AI commented Mar 16, 2026

@liunick-msft I've opened a new pull request, #264, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot AI and others added 2 commits March 16, 2026 08:53
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants